home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / dtype / fontdt12.lha / FontDT.guide (.txt) < prev    next >
Amigaguide Document  |  1996-05-06  |  16KB  |  361 lines
  1. @database FontDT
  2. @$VER: FontDT.guide 39.4 (3.5.96)
  3. @(C) Michal Letowski
  4. @author Michal Letowski
  5. @index Index
  6. @node Main "FontDT 1.2"
  7. @prev Main
  8. @next Main
  9.                                   @{b}@{u}FontDT 1.2@{uu}@{ub}
  10.              @{b}FontDT@{ub} package is Copyright 
  11.  1995 @{"Michal Letowski" link Author}.
  12.                              All rights reserved.
  13.       The author's native language is Polish, so please forgive bad spelling,
  14.   grammar mistakes etc. Or better - correct them.
  15.   @{"Copyright notice" link Copyright} - legal informations.
  16.   @{"  Introduction  " link Introduction} - what it is useful for.
  17.   @{"  Requirements  " link Requirements} - what you need to run.
  18.   @{"  Installation  " link Installation} - how to install.
  19.   @{"  Configuration " link Configuration} - how to customize.
  20.   @{"      Notes     " link Notes} - some notes and comments.
  21.   @{"     History    " link History} - what have changed since last release.
  22.   @{"      To do     " link ToDo} - what needs to be done.
  23.   @{"    font_dtc    " link AutoDocs/font_dtc.doc/main} - programmer's documentation.
  24. @endnode
  25. @node Copyright "FontDT Copyright"
  26. @prev Copyright
  27.   @{b}@{u}Copyright@{uu}@{ub}
  28.   @{b}FontDT@{ub} package is Copyright 
  29.  1995-96 @{"Michal Letowski" link Author}.
  30.   @{b}FontDT@{ub} is freely distributable under the following conditions:
  31.  no more than a reasonable fee is charged for copying/downloading;
  32.  this distribution is not a part of other non-free distribution;
  33.  the distribution is complete - it contains all the files (full list
  34.       at the end of this chapter);
  35.  no file in the distribution is changed.
  36.       Distribution without meeting conditions specified above requires
  37.   written permission from me.
  38.       "Amiga Shopper" have a special permission to distribute this package
  39.   on their coverdisks.
  40.       The @{"DataType" link DataTypes} from the package works, but no guarantee is given nor
  41.   implied. In no case will I be liable for any results of using supplied
  42.   @{"DataType" link DataTypes}.
  43.       The source code is provided only for informational purposes and is
  44.   also under copyright. It is based on source for @{i}bmp.datatype @{ui}by David
  45.   N. Junod.
  46.       This documentation is based on @{i}CatEdit.guide@{ui}, which is Copyright 
  47.   1993 Rafael D'Halleweyn.
  48.       Compugraphic, CG and Intellifont are registered trademarks of Agfa
  49.   Corp.
  50.   List of all files in the distribution:
  51.     @{i}Install FontDT.info
  52.     Install FontDT
  53.     FontDT.guide.info
  54.     FontDT.guide
  55.     AutoDocs (dir)
  56.       font_dtc.doc
  57.     Devs.info
  58.     Devs (dir)
  59.       DataTypes.info
  60.       DataTypes (dir)
  61.         Bitmap Font.info
  62.         Bitmap Font
  63.         Outline Font.info
  64.         Outline Font
  65.     Libs (dir)
  66.       DataTypes (dir)
  67.         font.datatype
  68.     Prefs (dir)
  69.       Env-Archive
  70.         DataTypes
  71.           font1.prefs
  72.           font2.prefs
  73.           font3.prefs
  74.           font4.prefs
  75.       Presets
  76.         def_font1.info
  77.         def_font2.info
  78.     Src (dir)
  79.       classbase.c
  80.       classbase.h
  81.       classbase.i
  82.       classinit.asm
  83.       dispatch.c
  84.       dispatch.h
  85.       endcode.asm
  86.       font.rev.i
  87.       otag.c
  88.       otag.h
  89.       prefs.c
  90.       prefs.h@{ui}
  91. @endnode
  92. @node Introduction "Introduction to FontDT"
  93.   @{b}@{u}Introduction@{uu}@{ub}
  94.       @{b}FontDT@{ub} is a @{"DataTypes" link DataTypes} subclass for loading and displaying @{"Amiga fonts" link Fonts}.
  95.   Once installed it will let all @{"DataTypes" link DataTypes} aware programs to recognize and
  96.   load @{"Amiga fonts" link Fonts} as pictures.
  97. @endnode
  98. @node Requirements "Requirements for FontDT"
  99.   @{b}@{u}Requirements@{uu}@{ub}
  100.       @{b}FontDT@{ub} requires AmigaDOS 3.0 or higher (@{i}datatypes.library @{ui}and
  101.   @{i}diskfont.library @{ui}V39+). Outline fonts subsystem (@{i}bullet.library @{ui}V39+)
  102.   is required for accesing @{b}Compugraphic@{ub} fonts. 3rd party libraries are
  103.   necessary for viewing @{b}non-Compugraphic@{ub} outline fonts (eg. @{i}type1.library@{ui}
  104.   by Amish S. Dave for @{b}Adobe Type1@{ub} fonts).
  105. @endnode
  106. @node Installation "Installation of FontDT"
  107.   @{b}@{u}Installation@{uu}@{ub}
  108.       Use supplied @{i}Installer @{ui}script to copy necessary files. If you
  109.   go for "Manually Selectable" installation you will need to activate class
  110.   by double-clicking on @{i}DEVS:DataTypes/Bitmap Font @{ui}and
  111.   @{i}DEVS:DataTypes/Outline Font @{ui}icon or using @{i}AddDataTypes @{b}REFRESH @{ub}@{ui}from Shell.
  112.       Please note that neither sample config files nor icons will be
  113.   installed by the script (if you want to use them, you must copy them
  114.   manually).
  115. @endnode
  116. @node Configuration "Configuring operation of FontDT"
  117.   @{b}@{u}Configuration@{uu}@{ub}
  118.       You can use config files to customize operation of @{b}FontDT@{ub} and thus
  119.   appearance of fonts on screen. The two config files are
  120.   @{i}PROGDIR:Prefs/DataTypes/font.prefs@{ui} (@{i}PROGDIR: @{ui}is a standard system
  121.   assign and denotes drawer where given application resides) and
  122.   @{i}ENV:DataTypes/font.prefs @{ui}(searched in that order). Such setup seems to be
  123.   standard across 3rd party @{"DataTypes" link DataTypes}.
  124.       Each config file is a multi-line ASCII file. All lines are joined
  125.   together and then parsed using standard AmigaDOS template method.
  126. @{fg highlight}SYNOPSIS@{fg text}
  127.       [@{i}Strings@{ui}] [@{b}CENTER@{ub}] [@{b}INVERSE@{ub}] [@{b}FONTNAME@{ub}] [@{b}DPI@{ub}=@{i}DPI@{ui}]
  128.                 [@{b}FOREGROUND@{ub}=@{i}ForegroundColor@{ui}] [@{b}BACKGROUND@{ub}=@{i}BackgroundColor@{ui}] 
  129. @{fg highlight}TEMPLATE@{fg text}
  130.       "STRINGS/M,CENTER=CENTRE/S,INVERSE/S,FONTNAME/S,DPI/K,
  131.        FG=FOREGROUND/K,BG=BACKGROUND/K"
  132. @{fg highlight}PARAMETERS@{fg text}
  133.       @{i}Strings @{ui}- strings to display instead of default text. By default,
  134.   @{b}FontDT@{ub} will show a text consisting of all characters present in a given
  135.   font. You can change this by supplying your own strings which will be used
  136.   in place of this default string. Each string (separated by spaces) will be
  137.   displayed as one line. If you want your text to contain spaces, enclose it
  138.   in "".
  139.       @{b}CENTER@{ub} - this option causes each line to be centered before displaying.
  140.   Only useful if you have supplied more than one own string or are trying to
  141.   display font with more than one size.
  142.       @{b}INVERSE@{ub} - for two-color fonts this causes @{b}FontDT@{ub} to swap foreground
  143.   and background colors. Does not work for color fonts.
  144.       @{b}FONTNAME@{ub} - if this option is given a line containing font's name and
  145.   size will be printed before user strings.
  146.       @{b}DPI@{ub} - this strings describes font's acpect ratio. It should contain
  147.   values for XDPI and YDPI (as described in Workbench manual), in
  148.   "XDPI/A/N,YDPI/A/N" format. The whole string must be enclosed in
  149.   double-quotes. Default values for aspect ratio are DiskFont's defaults. At
  150.   present this option is only useful with outline fonts.
  151.       @{b}FOREGROUND@{ub} - describes foreground color. The string should
  152.   contain levels of red, green and blue, respectively. The template is
  153.   "R=RED/A/N,G=GREEN/A/N,B=BLUE/A/N". The whole string must be enclosed in
  154.   double-quotes. Default foreground color is black. This option doesn't
  155.   work for color fonts.
  156.       @{b}BACKGROUND@{ub} - describes background color. The string should
  157.   contain levels of red, green and blue, respectively. The template is
  158.   "R=RED/A/N,G=GREEN/A/N,B=BLUE/A/N". The whole string must be enclosed in
  159.   double-quotes. Default background color is white. This option doesn't
  160.   work for color fonts.
  161. @{fg highlight}EXAMPLES@{fg text}
  162.       @{fg fill}@{i}FontDT is great@{ui}@{fg text} will produce:
  163. @{bg highlight}FontDT
  164. great@{bg back}
  165.       @{fg fill}@{i}"FontDT is great"@{ui}@{fg text} will produce:
  166. @{bg highlight}FontDT is great@{bg back}
  167.       @{fg fill}@{i}"FontDT is" "great" @{ui}@{b}CENTER@{ub}@{fg text} will produce:
  168. @{bg highlight}FontDT is
  169.   great  @{bg back}
  170.       @{fg fill}@{i}"FontDT is" "great" @{ui}@{b}CENTER@{ub} @{b}INVERSE@{ub}@{fg text} will produce:
  171. @{fg highlight}@{bg text}FontDT is
  172.   great  @{fg text}@{bg back}
  173.       @{fg fill}@{b}FONTNAME@{ub}@{fg text} will produce:
  174. @{bg highlight}Times.font 12
  175. ABCDEFGHIJKLMNOPQ...
  176. Times.font 15
  177. ABCDEFGHIJKLMNOPQ...
  178. Times.font 18
  179. ABCDEFGHIJKLMNOPQ...@{bg back}
  180.       @{fg fill}@{i}"" @{ui}@{b}FONTNAME@{ub}@{fg text} will produce:
  181. @{bg highlight}Times.font 12
  182. Times.font 15
  183. Times.font 18@{bg back}
  184.       @{fg fill}@{i}"FontDT is great" @{ui}@{b}FONTNAME@{ub}@{fg text} will produce:
  185. @{bg highlight}Times.font 12
  186. FontDT is great
  187. Times.font 15
  188. FontDT is great
  189. Times.font 18
  190. FontDT is great@{bg back}
  191. @{fg highlight}SAMPLE CONFIGS@{fg text}
  192.       @{"Config 1" link Prefs/Env-Archive/DataTypes/font1.prefs/main}
  193.       @{"Config 2" link Prefs/Env-Archive/DataTypes/font2.prefs/main}
  194.       @{"Config 3" link Prefs/Env-Archive/DataTypes/font3.prefs/main}
  195.       @{"Config 4" link Prefs/Env-Archive/DataTypes/font4.prefs/main}
  196. @endnode
  197. @node Notes "FontDT Notes"
  198.   @{b}@{u}Notes@{uu}@{ub}
  199.       @{b}FontDT@{ub} shows all available sizes of a given font.
  200.       Since version 1.2 the font you want to view doesn't have to be in
  201.   @{i}FONTS: @{ui}path. To achieve that @{i}FONTS: @{ui}assign is extended for the duration
  202.   of @{b}FontDT@{ub} operation.
  203.       If you have bitmaps created for outline fonts, the DataType will only
  204.   show the sizes for which the bitmaps exist. Otherwise, it will try to show
  205.   all sizes specified with @{i}Intellifont @{ui}utility. If you have many sizes (or
  206.   don't have any) this will likely fail.
  207.       If you get "Out of memory" messages from your @{"DataTypes" link DataTypes} application,
  208.   then this is probably caused by too wide default string (which is made of
  209.   all available font characters). Use config files to change default string.
  210.   Choose shorter string or the one made of several lines.
  211.       For color fonts with many sizes color is set for the biggest size.
  212.       I suggest not to use @{b}FontDT@{ub} for Workbench patterns because of
  213.   possibility of hanging your machine. This is caused by insufficient stack
  214.   space for @{i}IPrefs @{ui}program which handles Workbench patterns. Since it's not
  215.   really my fault I'm not going to fix that. Anyway, if you decide to utilize
  216.   @{b}FontDT@{ub} for Workbench patterns then please note that in such case only
  217.   @{i}ENV:DataTypes/font.prefs @{ui}config file will be used.
  218. @endnode
  219. @node History "FontDT History"
  220.   @{b}@{u}History@{uu}@{ub}
  221.       @{b}Version 1.0 (22.4.95)@{ub} - initial release.
  222.       @{b}Version 1.1 (8.7.95)@{ub}
  223.     Improvements:
  224.  @{b}FOREGROUND@{ub} and @{b}BACKGROUND@{ub} configuration options added;
  225.  @{b}FONTNAME@{ub} can be used together with user text;
  226.  Included two icons for easier fonts viewing (one normal style, one
  227.   color by Barry McConnell);
  228.  @{b}DPI@{ub} configuration option added;
  229.     Bug fixes:
  230.  Two hypothetical bugs fixed;
  231.  Fonts containing all ASCII characters weren't showed at all;
  232.  Fixed bug in outline fonts opening code;
  233.  No longer asks for @{i}PROGDIR: @{ui}when used by @{i}IPrefs@{ui}.
  234.       @{b}Version 1.2 (6.5.96)@{ub}
  235.     Improvements:
  236.  Fonts being viewed no longer need to be in FONTS: path;
  237.  Configuration files may span several lines now;
  238.  Shorter code.
  239.     Bug fixes:
  240.  Memory leakage (about 432 bytes on each run) fixed.
  241. @endnode
  242. @node ToDo "To do in FontDT"
  243. @next ToDo
  244.   @{b}@{u}To do@{uu}@{ub}
  245.       @{b}FontDT@{ub} will not deal correctly with some of the less used fonts
  246.   formats. If you find that your font is not displayed correctly (this
  247.   particularly applies to color fonts) please send it to me, so I can
  248.   improve the code.
  249.       Future versions may have ability to show just specified sizes of the
  250.   font.
  251. @endnode
  252. @node DataTypes "DataTypes Information"
  253. @prev DataTypes
  254. @next DataTypes
  255.   @{b}@{u}DataTypes@{uu}@{ub}
  256.       @{i}DataTypes @{ui}is an AmigaDOS subsystem (introduced in AmigaDOS 3.0) for
  257.   dealing with different types of files found on different machines (PC's,
  258.   Macs and Amigas). @{i}DataTypes @{ui}can be used to recognize type of any file
  259.   and to interpret informations stored in that file. A client application
  260.   such as @{i}MultiView @{ui}can then show that data in an appropriate way.
  261.       @{i}DataTypes @{ui}divide all files into the following main categories:
  262.       
  263.  @{i}syst @{ui}(System) - system files;
  264.       
  265.  @{i}text @{ui}(Text) - textual files;
  266.       
  267.  @{i}docu @{ui}(Document) - documents (spreadsheet data, text with
  268.         pictures etc.);
  269.       
  270.  @{i}soun @{ui}(Sound) - sound samples;
  271.       
  272.  @{i}inst @{ui}(Instrument) - musical instruments;
  273.       
  274.  @{i}musi @{ui}(Music) - songs;
  275.       
  276.  @{i}pict @{ui}(Picture) - graphics;
  277.       
  278.  @{i}anim @{ui}(Animation) - animations;
  279.       
  280.  @{i}movi @{ui}(Movie) - animations with sound.
  281.       Each category is further divided into sub-classes. Each sub-class
  282.   interprets one type of file, converting it to some universal format.
  283.   @{b}font.datatype@{ub} is a sub-class of Picture group.
  284. @endnode
  285. @node Fonts "Amiga fonts"
  286. @prev Fonts
  287. @next Fonts
  288.   @{b}@{u}Amiga fonts@{uu}@{ub}
  289.       Amiga fonts come in three basic types:
  290.       
  291.  traditional @{i}bitmap fonts @{ui}are two-color fonts. For each size there
  292.   exists a separate file containing bitmap description of all characters
  293.   designed for that size.
  294.       
  295.  @{i}color fonts @{ui}are stored like bitmap ones, but they may contain
  296.   additional informations about color palette used when putting them on
  297.   screen.
  298.       
  299.  @{i}outline fonts @{ui}were introduced with release 2.04 of the operating
  300.   system. Each outline fonts contains vector description of its characters
  301.   which can be reproduced at any size - because they are scalable. From
  302.   release 3.0 of the operating system it is possible to use outline fonts
  303.   other than @{b}Compugraphic@{ub} (with additional software).
  304.       Each font has a description file (@{i}xxxxx.font@{ui}) containing informations
  305.   about available sizes and their properties. @{b}FontDT@{ub} operates on such files
  306.   @{u}only@{uu}.
  307. @endnode
  308. @node Author "About the Author"
  309. @prev Author
  310. @next Author
  311.   @{b}@{u}About the Author@{uu}@{ub}
  312.       My name is @{b}Michal Letowski@{ub} and I hold Master degree in Computer
  313.   Science. I live in Wroclaw, Poland where I work as a information science
  314.   teacher in XXIV Secondary School.
  315.       If you have something to say me (questions, remarks, suggestions,
  316.   wishes, bug reports) please contact me (I like receiving mail!):
  317.     by E-Mail (preferred way):
  318.       @{b}pro37@ci3ux.ci.pwr.wroc.pl@{ub} (valid until 1.7.96)
  319.     by normal mail:
  320.       @{b}Michal Letowski
  321.       Przyjazni 51/17
  322.       53-030 Wroclaw
  323.       POLAND@{ub}
  324.       You can get the following free software written by me:
  325.    @{"  BYTEmark " beep} - Amiga port of @{i}BYTE @{ui}magazine portable benchmarks.
  326.       (@{i}Aminet://util/moni/BYTEmark-2.1.lha@{ui});
  327.    @{"   MakeDT  " beep} - create DataTypes recog files easily
  328.       (@{i}Aminet://dev/misc/MakeDT-1.3.lha@{ui});
  329.    @{" MCommands " beep} - 8 useful AmigaDOS CLI commands
  330.       (@{i}Aminet://util/cli/MComms-1.4.lha@{ui});
  331.    @{"    MCEd   " beep} - 8 great ARexx scripts for @{i}CygnusEd @{ui}users
  332.       (@{i}Aminet://text/edit/MCEd-1.2.lha@{ui});
  333.    @{"    MSys   " beep} - 4 AmigaDOS replacement commands
  334.       (@{i}Aminet://util/sys/MSys-1.0.lha@{ui});
  335.    @{"ClipHandler" beep} - easily exchange data between AmigaDOS and applications
  336.       (@{i}Aminet://util/misc/ClipHan-1.2.lha@{ui});
  337.    @{"   FontDT  " beep} - DataType for Amiga fonts
  338.       (@{i}Aminet://util/dtype/FontDT-1.2.lha@{ui});
  339.    @{"   MREKO   " beep} - DataType for viewing @{i}REKO @{ui}cardsets
  340.       (@{i}Aminet://util/dtype/MREKO-1.0.lha@{ui});
  341.    @{"   XPKDT   " beep} - DataType for XPK packed files.
  342.       (@{i}Aminet://util/dtype/XPKDT-1.0B.lha@{ui}).
  343. @endnode
  344. @node Index "FontDT Index"
  345. @prev Index
  346. @next Index
  347.   @{b}@{u}Index@{uu}@{ub}
  348.   @{"     Author     " link Author}
  349.   @{"  Configuration " link Configuration}
  350.   @{"Copyright notice" link Copyright}
  351.   @{"    DataTypes   " link DataTypes}
  352.   @{"      Fonts     " link Fonts}
  353.   @{"     History    " link History}
  354.   @{"  Installation  " link Installation}
  355.   @{"  Introduction  " link Introduction}
  356.   @{"      Notes     " link Notes}
  357.   @{"  Requirements  " link Requirements}
  358.   @{"      To do     " link ToDo}
  359.   @{"    font_dtc    " link AutoDocs/font_dtc.doc/main}
  360. @endnode
  361.